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REGISTRATION CARD: 


Please fill out and return at your earliest convenience, the 
enclosed registration card. This will enable Saturn Systems to 
notify you concerning future updates and new software releases 
relating to the Saturn 32K RAM board. 


SERVICE: 


If your Saturn 32K RAM board should require service, please 
return it to the dealer from whom it was purchased, or send it 
postage paid directly to Saturn Systems, Inc. Be sure to include 
proof of purchase. 


Ship to: Saturn Systems, Inc. 
P.O. Box 8050 
Ann Arbor, MI 48107 


Chapter 1 
INTRODUCTION 


The Saturn 32K Ram Board is an expansion plug-in card 
designed to provide an extra 32K bytes of random access memory 
for Apple II and Apple II plus computers. To make use of the 
additional memory, Saturn Systems provides a package of applica- 
tions software at no additional charge. The Saturn 32K board and 
accompanying software requires that the Apple be outfitted with a 
full 48K of main board RAM, as most Apples are today. 


The 32K Ram board is compatible with software designed to 
run with Apple's Language Card (PASCAL, FORTRAN, LISA ver 2, 
etc.) as well as Microsoft's RamCard and 280 Softcard (CP/M, 
COBOL-80, FORTRAN-80, etc.). This compatibility is possible due 
to its unique organization. The board consists of two 16K banks 
of memory, accessed one at a time. In this sense, the Saturn 32K 
board can be thought of as two 16K Ram boards occupying the same 


slot. The first of these 16K banks is controlled through soft- 
ware in exactly the same manner as Apple's Language Card and 
other 16K memory cards. As a result, existing software designed 


to run with the 16K memory boards and Apple Language Card will 
operate on the Saturn 32K board without modification. 


Using DOS 3.3, the version of BASIC not resident in ROM 
(Integer for an Apple II plus or Applesoft.for an Apple II) will 
automatically be loaded into the first 16K of the Saturn 32K 
board upon boot. This enables easy access to either BASIC (via 
INT or FP). In this respect the Saturn 32K board appears as a" 
16K RAM board. However, in addition to this first bank of 16K, a 
second bank is available as well. The software provided with the 
32K board takes advantage of the additional 16K of memory by 
moving (relocating) DOS 3.2 or DOS 3.3 into this portion of the 
memory board, thus freeing up approx. 10K of main board RAM for 
program use. The relocated DOS can also be configured to use an 


Apple Integer or Applesoft card, if present. Thus the board 
serves a dual purpose by: 


1. Maintaining the alternate BASIC (version of BASIC not 
resident in main board ROM). 


2. Housing DOS. 


In this way, flexibility is provided, allowing one to take 
advantage of existing hardware and software in addition to the 
extra RAM present on the Saturn 32K RAM board. 


Chapter 2 


INSTALLATION INSTRUCTIONS 


I. RECOMMENDED LOCATION 


Although the Saturn 32K RAM Board can be operated from any 
slot which has space at the rear for the switch to protrude 
through (slots 0, 2, and 4), it is recommended that it be located 
in slot O. This is because much of the existing software which 
runs on Apple's Language card and other manufacturers' 16K 
boards, as well as the Saturn 32K board, requires that memory 
card be located in slot O in order to use it. Therefore, if an 
APPLESOFT or INTEGER firmware card is already present in slot O, 
it should be moved to another slot. Discussion concerning the 
use of the APPLESOFT and INTEGER firmware cards from a slot other 
than O is given in Chapter 4. 


I. SLOT O INSTALLATION 


1. Turn off the power to the Apple (check the power light to 
insure that it is not on). 


2. Remove the cover by pulling on the right and left rear 
corners of the case, until both fasteners are released (popping 
sound); slide the cover back until the front edge clears the lip 
of the case, and lift up. 


3. Find slot O. Slot number designations are printed on the 
Apple's main circuit board along the back edge near the cutouts , 
in the case. The leftmost slot is slot zero (closest to the power 
supply, which is a long metal box). 


4. Before touching any component or board in the Apple, 
discharge any static charges, by touching the power supply cover 
(long metal box at left side of Apple) immediately prior to 
touching the component or card in the Apple. 


5. If there is a card present in slot O, remove it by pulling at 
the top while rocking gently. Either plug this card into another 
slot or set it safely aside. 


6. Locate the motherboard RAM memory: 3 horizontal rows of 


eight chips inside large white box in the center of the Apple 
circuit board. 


7. Touch the metal cover of the power supply and carefully 
remove the memory chip located at the leftmost position of the 
center row of eight memory chips. (See figure next page). The 


chip should be removed from its socket by inserting the blade of 
a small screwdriver alternately under the top and bottom edges of 
the memory chip and prying gently, working the chip slowly out of 
its socket by small increments. Try not to touch the pins of the 


chip to further avoid exposure of the chip to static charges. If 
removed in this manner, the chip will come out with all: pins 
intact and unbent, and can be saved as a spare. Do not attempt 
to pull the chip out with bare hands, since this will most assur- 
edly result in bent or broken pins. 
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8. Place the memory chip in a safe place. It is recommended 
that the chip be stored in antistatic or conductive foam. If 
none is available, the chip can be wrapped in aluminum foil. 
This will prevent it from being inadvertantly damaged by static 


electricity during storage. 


9. 


made 


Unpack the memory board. The memory board is packed in a bag 


of specially treated antistatic material to prevent damage 


during shipment. It should be stored in this bag when not 
installed in the Apple, or if transported outside the Apple. 


10. 


Examine the memory board. 


A. With the Saturn board placed face up (chips on top), 
and the switch pointing to the right, locate the cable and 
plug at the left side of the board. | 


B. Examine the cable. The ribbon cable should protrude from 
the right side of the socket be bent in such a manner that 
the free end (with plug) extends past the bottom of the board. 


c. Examine the end of the cable which is already plugged 
into the board to insure that it was not unseated during 
shipment (apply moderate pressure to the assembly). 

11. Remove the protective foam from the free end of the cable. 


12. Install the board in slot O: 


A. Touch the power supply cover to discharge any static 
charges. ` 

B. Grasp the board at its edges and position over slot 0. 
C. Align the gold edge connector fingers with the slot of 
the socket, centering the card in the socket prior to 
insertion. Insure that the connector cable plug is not in 
the way and won't be pinched by the card when installed. 

D. Be sure that the switch protrudes through the slot in 
the Apple. . 


E, Apply gentle downward pressure with slight front to back 
rocking until the card seats fully. 


13. Install the connector plug into the empty motherboard RAM 
socket. 


A. Touch the power supply cover. Align the pins of the 
plug with the receptacles in the empty RAM socket. The edge 
of the plug bearing white markings should face the FRONT 

of the Apple (keyboard). 


B. Apply gently downward pressure, slowly working the pins 
of the plug into the socket. CAUTION: do not force! If 
the plug does not appear.to be going in easily, remove it. 
Examine for any bent pins, and try again. 


c. Double check to ensure that the plug is well seated with 
all pins installed in their respective socket holes. 
D. Insure that the white marks printed on the edge of the 
plug point toward the front (keyboard) of the Apple. 
l4. Replace the cover by placing over opening, sliding forward 
until properly aligned, and applying pressure at the back until 
it snaps into place. Be careful not to apply pressure to the 


front of the Saturn 32K board as this may unseat the card. 


III. INSTALLATION INTO A SLOT OTHER THAN ZERO 


The Saturn 32K RAM Board can be installed in any of the 
slots which will accomodate the switch (0, 2, 4). The procedure 
for installing the card in slots 2 or 4 is the same as Given for 





slot 0 (above) except steps 7 and 12. Instead of removing the 
leftmost memory chip in the middle row of RAM chips, the memory 
chip in the socket immediately to the right of the card when 
inserted into the desired slot should be removed, as indicated in 
the figure below. (Note: as far as the operation of the card is 
concerned, any one of the 24 memory chips could be removed and 
substituted with the connector plug. The locations chosen are 
those which provide for most convenient placement of the plug and 
cable assembly.) 
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IV. INSTALLING ADDITIONAL SATURN 32K RAM BOARDS 


The same procedure is followed for installation of multiple 
Saturn 32K boards, as was used to install the first. The memory 
chip located nearest the slot into which the card is being 
installed is removed (see previous section) and replaced with the 
cable connector attached to the card being installed. 


Note: The use of more than one Saturn 32K RAM Board may 
exceed the power supply capabilities of the Apple. This. will 
depend upon the power consumption of other cards present in the 
system. The Saturn 32K RAM Board draws most of its power off the 
+12V supply (see specifications). A fan may be required to 
remove the additional heat generated by the Saturn 32K RAM Board, 
particularly when more than one is present in the system. Again, 
this will depend upon what other cards are present in the system. 


Chapter 3 
USING THE SATURN 32K- BOARD 


Procedures for using the Saturn 32K RAM board are described 
in this chapter, with particular emphasis being given to the 
operation of the card with APPLESOFT and INTEGER BASIC under DOS 
3.2 and DOS 3.3. A separate chapter has been devoted to the use 
of the DOS relocation software included with the Saturn 32K RAM 
board (see Chapter 4). 


As indicated in the introduction to this manual, the Saturn 
32K RAM board has been designed to be compatible with existing 
software which runs on Apple's Language card and other manufact- 
urers 16K memory boards. Compatibility is maintained because 
half of the board (first bank of 16K) is accessed in the same 
manner as the language card, and therefore appears as such to the 
software. 


NOTE: The only feature that Apple's Language card has which 
is not present on the Saturn 32K RAM Board is an Autostart ROM. 
This may affect operations in a few instances, with software 
designed to use the language card. The situation arises with 
Apple II's which do not have an Autostart ROM on-board. The 
problem can be solved by installing, as a retrofit, the Autostart 
ROM in the Apple II main board in place of the standard monitor 
ROM. This retrofit installation will provide to the Apple II 
auto~boot features as well. 


In most instances, the operation of the memory board is 


transparent to the user, i.e., when the particular software 
system being used is booted, this software recognizes the memory 
board and uses it automatically. Much of this software is only 


provided on 16 sector disk (DOS 3.3), for example Apple FORTRAN, 
PASCAL, CPM56 (for upgrading CP/M systems to take advantage of 
the memory board), and thus requires a 16 sector system (DOS 3.3) 
for operation. Where use of this software is required, upgrading 
to a 16 sector system is recommended. 


Examples of software which will use the Saturn 32K RAM Board 
are given below: 


Personal Software's VisiCalc CP/M 
Apple's PASCAL Microsoft's FORTRAN-80 
Apple's FORTRAN Microsoft's COBOL-80 
Integer BASIC etc. 


Applesoft BASIC 


For further details concerning booting these systems and 
operating them, consult the respective instruction manuals. 


Note: When using PASCAL, the switch on the Saturn 32K board 
should be in the "up" position to ensure proper operation when 








RESET is pushed. 


I. USE WITH APPLESOFT AND INTEGER BASIC 


One of the features which is available with the Saturn 32K 
RAM Board is the ability to have Applesoft or Integer BASIC 
present in the 32K Ram Board and access these in a similar manner 
as one does using an Apple Firmware card (Integer card or Apple- 
soft card). 


A. APPLE II: 


Since Apple II's are provided with Integer BASIC in ROM, 
Applesoft can be made available by loading it into the Saturn 32K 
RAM Board (lower 16K of this card). When Applesoft is required, 
it can be accessed by typing FP. The portion of the first bank 
of the Saturn 32K RAM Board containing Applesoft is then enabled, 
which brings APPLESOFT into the machine in place of the main 
board ROM Basic (INTEGER). 


B. APPLE II PLUS: 


Apple II plus' have Applesoft in ROM. Integer BASIC can be 
loaded into the Saturn 32K board and accessed later by typing 
INT. This results in enabling the portion of the 32K board which 
contains Integer, bringing it into the Apple in place of Apple- 
soft. In either case, as far as this application is concerned, 
the Saturn 32K RAM Board operates as either an Integer card (for 
Apple II Plus) or an Applesoft card (for Apple II). 


For the above operation to occur with either DOS 3.2 or 3.3, 
the Saturn 32K card must be located in slot 0, for the above 
operation to occur, and, as a result, an Integer or Applesoft 
card previously in slot 0 is no longer used, once the Saturn 32K 
RAM Board has been located in this slot. There is no provision 
in the standard DOS 3.2 or 3.3 for accessing an Applesoft or 
Integer card which is located in a slot other than zero. How- 
ever, this capability has been provided in the DOS relocation 
software (MOVEDOS) included with the Saturn 32K RAM Board (see 
Chapter 4). 


II. SATURN 32K RAM BOARD OPERATION WITH DOS 3.3 


DOS 3.3 is designed to take advantage of an Apple Language 
card, 16K memory card, or Apple Firmware card (INTEGER or 
APPLESOFT card). The HELLO program provided on the distribution 
copy of DOS 3.3 tests for the presence of an Integer or Applesoft 
card, or language card (16K memory card) in slot 0, and if the 
latter is present, loads the required language (Applesoft in an 
Apple II, or Integer in an Apple II Plus) from disk into the 


10 


memory card. The distribution copy of DOS 3.3 contains copies of 
the ROM versions of both Applesoft and Integer BASIC, saved as 
binary files. Whenever DOS 3.3 is boóted, this loading process 
is repeated, provided that the HELLO program as well as the 
required BASIC (binary file) is present on the particular disk 
being booted. . 


In this respect the Saturn 32K board operates as a language 
card, and appears to DOS as such. If placed in slot 0, the 
required Basic will be automatically loaded upon boot, just as 
occurs with the Apple Language card, or other 16K memory boards. 


III. SATURN 32K RAM BOARD OPERATION WITH DOS 3.2 


DOS 3.2 is designed to take advantage of an Apple Firmware 
card (INTEGER card or APPLESOFT card) if present. In order to 
use this card, it must be located in slot O. When a language 
card, 16K memory card, or the Saturn 32K card is used in slot 0 
(for maximal compatibility with software designed to use it), the 
BASIC present in the Integer or Applesoft card is no longer 
available. In order to get around this accessibility problem, the 
version of BASIC present on the firmware card (APPLESOFT for 
Apple II; INTEGER for Apple II Plus) can be moved to the Saturn 
32K board, thus enabling DOS 3.2 to gain access to it through 
slot O. Once this BASIC is present in the Saturn 32K board, DOS 
will treat the board just as if it were a firmware card (APPLE- 
SOFT or INTEGER card). The transfer can be accomplished using a 
utility program provided on the diskette included with the Saturn 
32K board. The procedure involves 1) making a disk copy of the 
BASIC present in the Apple Firmware card, and 2) loading this 
copy (ROM image) of the desired BASIC into the Saturn 32K card in 
slot 0. A step-by-step procedure is given below: 


1. In order to make a disk copy of the Basic present in the 
Apple Firmware card (APPLESOFT or INTEGER), the Firmware card 


must be located in slot O. Therefore, turn the power off and 
move this card to slot 0, by first removing the Saturn 32K card 
from this slot (if present). Be sure to replace the memory chip 


that was previously removed, and observe that the orientation of 
this chip in the socket matches the others in the RAM section 
(markings on the memory chip are pointed in the same direction as 
the other memory chips). 


2. Power up the Apple and boot a standard DOS 3.2 system disk. 


3. Insert the diskette included with the Saturn board and run 
the corresponding utility program: COPYINTEGER for an Apple II 
Plus or  COPYAPPLESOFT for an Apple II in order to make a disk 
copy. When the program prompts you, insert the disk upon which a 
copy of the BASIC is desired. 


4. Turn off the power. Remove the firmware card from slot 0 and 
replace it with the Saturn 32K RAM Board (see installation instr- 
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uctions, Chapter 2). 


5. Power up the Apple and again boot a standard DOS 3.2 system 
disk. 
6. Transfer the required loading program (below) from the disk- 


ette included with the Saturn card to the diskette which contains 
the copy of BASIC (INTEGER or APPLESOFT) made in step 3. 


A. For Apple II: LOADFP 
B. For Apple II Plus: LOADINT 


7. Run this program: 


A. For Apple II, enter RUN LOADFP 
B. For Apple II Plus, enter RUN LOADINT 


The required BASIC will be loaded into the Saturn 32K RAM Board. 


8. Now if you type FP (on an Apple II) or INT (on an Apple II 
Plus) you should get the required language. 


The load program (LOADFP on Apple II or LOADINT on Apple II 
Plus) can be used as part of a HELLO program so that upon boot of 
DOS 3.2, the required BASIC will be automatically loaded into the 
Saturn 32K RAM Board. (This is actually what happens with DOS 
3.3 when a language card, 16K card, or the Saturn 32K board is 
present in slot 0.) Of course this requires a copy of the cor- 
responding BASIC on every disk that contains this HELLO program. 


IV. RAM/ROM SWITCH OPERATION [switch on back of board] 


The Saturn 32K board is equipped with a switch which can be 
accessed through one of the slots in the case of the Apple. The 
position of this switch determines what happens after pressing 
RESET. 


NOTE: Use of this switch applies only when BASIC is present in. 
the 32K board. If an INTEGER or APPLESOFT card is being used, 

refer to its instructions concerning operation of thé switch on 

this card. 


What actually takes place upon RESET will depend upon 
whether the Apple II has an Autostart ROM installed on the main 
board. 


A. WITH AUTOSTART ROM: 


When an Autostart ROM is present as one of the main board 
ROMs (standard on Apple II Plus), the RAM/ROM switch on the 
Saturn 32K board has no effect. If one is in INTEGER BASIC and 
reset is pushed, return is to INTEGER BASIC (>); on the other 
hand, if one is in APPLESOFT and then reset is pushed, one is 
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returned to APPLESOFT (J). This will occur whether the switch is 
up or down. 


B. WITH MONITOR ROM (NO AUTOSTART ROM): 


This situation applies to Apple II's which do not have an 
Autostart ROM. What occurs upon reset will depend upon two 
things: (1) the position of the switch on the Saturn 32K board 
and (2) which BASIC is being used (INTEGER or APPLESOFT). 


1. INTEGER BASIC: When using INTEGER BASIC (present in 
main board ROM), pushing reset results in jumping to the monitor. 
This will occur regardless of the position of the switch on the 


Saturn 32K board. Return to INTEGER can be accomplished by 
entering 3D0G. 


2. APPLESOFT: When using APPLESOFT (resident in the Saturn 
32K board), the following will occur upon reset: 


a. If the switch is in the up position, then pushing 
reset will result in jumping back to APPLESOFT 
giving the prompt (]); i.e., the BASIC present 
in the Saturn board remains resident. 


b. If the switch is in the down position, pushing 
reset will result in a return to the monitor, 
present in the main board ROM, i.e., the Saturn 
32K board is disabled and the main board ROMs 
enabled. Return to Applesoft can be accomplished 
at this point with 3DOG. 


C. RECOMMENDED SWITCH POSITION 


In general it is suggested that the switch be left in the 
down position, until use in the other position is desired. 
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Chapter 4 
MOVEDOS - DOS RELOCATION SOFTWARE 


As indicated in the introduction, the software provided with 
the Saturn 32K board enables one to take advantage of the extra 
16K of RAM present on this card by moving DOS (DOS 3.2 or 3.3) up 
into this section of the board, thus freeing up approximately 10K 
of memory for user programs. 


In a 48K system, DOS normally resides at the top of the 48K 
of RAM, occupying 10.5K of RAM (from $9600 to $BFFF). HIMEM is 
set to reflect the presence of DOS (HIMEM = $9600). As long as 
DOS is resident, the memory occupied by it is not available for 
program use. The program MOVEDOS, provided with the Saturn 32K 
board, frees up 10K of the memory space normally occupied by DOS, 
while at the same time keeping DOS in the system, and available. 
This is accomplished by relocating (moving) DOS up into the 
Saturn 32K board and making appropriate modifications to the 
system so as to be able to communicate with this relocated DOS. 
DOS is kept in the 32K memory board, and used when required. 


Essentially DOS is stored in a portion of the Saturn 32K 


board which is disabled (turned off) until it is needed. As a 
result, when DOS is not being used, it isn't sitting in lower 
memory, taking up valuable space. When DOS is required, it is 


used in the following manner. 


l. The part of the Saturn 32K board which contains DOS is 
enabled (turned on). This results in BASIC (Integer 
or Applesoft) being disabled (turned off) and no longer 
resident.* This poses no problem, since BASIC is not 
required by DOS during the time a DOS command is being 
executed. 


2. The desired DOS command is executed by the relocated 
DOS, now resident in the system. 


3. The portion of the Saturn 32K board which contains DOS 
is disabled (turned off). The BASIC which had been 
present prior to the call to DOS is re-enabled, and 
control is returned to the program from which DOS was 
called. 


In this way, as far as the user is concerned, DOS is present 
in the system and there is 10K more memory available for program 
use. In addition, the user has access to either BASIC (Integer 
or Applesoft), since either of these can be present in the Saturn 
32K board as well as the relocated DOS. 

* Note: This occurs because the relocated DOS actually shares 
the memory space occupied by BASIC. ($D000-$FFFF). 
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I. FEATURES OF THE RELOCATED DOS 


All the features of normal DOS are retained in this relo- 
cated DOS, including the ability to initialize disks. When a 
disk is initialized, the relocated DOS is written to the disk 
from the Saturn 32K board. When this disk is later booted, the 
relocated DOS is brought into the 32K ram board properly, with 
everything set up to use it. Thus the program which does the 
actual relocation (MOVEDOS) only needs to be run once. 


The capability of using an Integer or Applesoft card in a 
‘slot other than O has been added to this relocated DOS. This 
enables one to take advantage of one of these cards if present, 
as well as the Saturn 32K RAM Board. Details of how to configure 
the system to take advantage of this are given later. 


MOVEDOS has been designed to operate with a 32K RAM board in 
a slot other than 0, and properly relocate DOS into this slot. 
MOVEDOS actually searches for the first 32 ` it finds 
starting at slot.0 and moving upward. Howe ff" for maximum 
compatibility with existing software, it is still recommended 
that the Saturn 32K RAM Board be located in slot 0. 


II. USING MOVEDOS 


The software provided with the Saturn 32K RAM Board is 


distributed on a ló-sector disk. It can be used directly with 
DOS 3.3, however it is recommended that a back-up be made as soon 
as possible. When using the software with DOS 3.2 it is sug- 


gested that the programs be converted to 16 sector format using a 
program such as DEMUFFIN prior to use. Again, a backup should be 
maintained. 


In order to relocate DOS, the program MOVEDOS is used. This 
program moves the existing copy of DOS (3.3 or 3.2) resident at 
the top of the 48K of user memory ($9600-$BFFF) into part of the 


Saturn 32K board and makes appropriate changes to enable 
communication with this relocated DOS, in place of the normal 
DOS. As stated previously, MOVEDOS does not require that the 


Saturn 32K RAM Board be present in slot 0, however this position- 
ing is recommended so that other software such. as PASCAL, 
VisiCalc, etc., will be able to find it. : | 


A. Running MOVEDOS with DOS 3.2 


i. Boot a standard DOS 3.2 system. 


KÉ Run the DEMUFFIN or similar program to convert the 
file MOVEDOS to 13 sector format. 
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3. ' Run MOVEDOS by typing BRUN MOVEDOS. The system will 
respond by displaying a message indicatinq that DOS is 
being loaded into the 32K board, the relocation will 
take place, and control will return to BASIC. 


4. A blank disk can be initialized in the normal manner, 
if desired, resulting in a copy of the relocated DOS 
which can later be booted, as with any disk that has 
been initialized. It is recommended that any disks 
initialized with the relocated DOS be labeled as such, 
to prevent possible confusion with normal DOS initial- 
ized disks. ` 


5. Integer BASIC (Apple II plus) or Applesoft (Apple II) 
can be loaded into the first half of the Saturn 32K 
board as described previously (chapter 3, part III) 
using a HELLO program, if desired. 


B. Running MOVEDOS with DOS 3.3 
l. Boot a standard DOS 3.3 system. 


2. Insert a l6-sector disk containing a copy of the 
MOVEDOS program (or the master itself - CAUTION!) and 
type BRUN MOVEDOS. The system will respond by display- 
ing a message indicating that DOS is being loaded into 
the 32K RAM board, the relocation will take place, and 
control will return to BASIC. 


3. A blank disk can be initialized with a copy of the 
relocated DOS which can be later booted, if desired, 
by following normal initialization procedures. It is 
recommended however, that any disks initialized with 
the relocated DOS be labeled as such to avoid possible 
confusion with normal DOS initialized disks. 


4. Integer BASIC (for an Apple II plus) or Applesoft (for 
an Apple II) can be loaded into the first half of the 
Saturn 32K board (unused by the relocated DOS) by 
running the standard HELLO program provided on the 
distribution copy of DOS 3.3. 


III. USING AN APPLESOFT OR INTEGER CARD 


As indicated previously, a provision has been made in the 
relocated DOS to enable the use of an Apple Firmware card 
(Integer card or Applesoft card) from a slot other than O. The 


relocated DOS is set up (as default) to look for the alternate 
BASIC (Applesoft in an Apple II and Integer in an Apple II plus) 
in the slot which contains the Saturn 32K board. It actually 
looks at the first 16K bank of the 32K board for the presence of 
the desired BASIC (the second half of this board contains the 
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relocated DOS). , 
This default can be easily changed using one of the 


configuration programs provided with the Saturn 32K board, so 
that the relocated DOS will go to a different. slot for this 
BASIC. One can then place the desired Apple Firmware card in 


this slot (Applesoft card for an Apple II; Integer card for an 
Apple II plus) and gain access to it. 


The following is a step by step procedure for making this 
change. 


1. Do one of the following: 
a) Boot a standard DOS (3.2 or 3.3) and run MOVEDOS 
b) Boot a relocated DOS from a previously initialized disk. 
2. Run the appropriate configuration program: 
a) SET INTEGER SLOT --- on an Apple II plus 
b) SET APPLESOFT SLOT - on an Apple II 
3. Enter the slot number containing the firmware card (Integer 
or Applesoft card) when prompted. The program will make the 


required changes to the relocated DOS currently resident so 
as to use this card. 


4. The relocated DOS with configuration intact can be saved at 
this point for future use by initializing a disk with this 
DOS. 


NOTE: The HELLO program used with this modified DOS should be 
changed so that it does not test for the presence of a language 
card in slot 0, and load Basic. Otherwise a copy of this Basic 
will be loaded into the first half of the 32K card in slot 0, as 
well as being present on the firmware card, from which it will be 
accessed when requested (by typing FP on an Apple II and INT on 
Apple II Plus). 


PRECAUTIONS CONCERNING BOOTING DISKS: 


This precaution applies to systems which have been config- 
ured (using the configuration program) to use an Integer or 
Applesoft firmware card with the relocated DOS. In this situa- 
tion, it is recommended that booting (via PR#6, etc.) be accomp- 
lished from the main board ROM BASIC (i.e. Applesoft in an Apple 
II plus; Integer for monitor] in an Apple II), and not from the 
BASIC present in the Apple Firmware card. This is to insure that 
the firmware card is not left on after the boot. 


The relocated DOS has. been designed to operate properly with 


an Applesoft or Integer card during the boot process, and can 
therefore be booted from either Integer or Applesoft. However, 
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the standard DOS 3.3 or 3.2 (such as that present on the system 
master) does not have a provision for use of an Integer or 
Applesoft card from a slot other than 0, with the relocated DOS. 
If the precaution is not taken to return to the main board ROM 
BASIC prior to the boot in this case, the firmware card will be 
left on after the boot with no way for DOS to turn it off, and 
the system will hang. 


In summary: 


When operating under the relocated DOS with an Integer or 
Applesoft card in a slot other than O, 


1. Boot a relocated DOS as usual, either from Applesoft or 
integer 


2. Boot a standard DOS only from the main board ROM BASIC, 


a) Integer [or monitor] on an Apple II. 
b) Applesoft on an Apple II plus. 


IV. COMPATIBILITY OF RELOCATED DOS WITH EXISTING SOFTWARE 


In many respects the relocated DOS can be treated just as a 


normal DOS 3.2 or 3.3. In some instances however, problems arise 
where a particular application program attempts to make internal 
modifications to DOS. Such programs may not operate properly 


since DOS is no longer located where it is expected by the 
program (i.e. at the top of the 48K of RAM). In these instances 
a modification of the particular program involved may be required 
to permit operation with the relocated DOS. 


Two programs provided on the DOS 3.3 system master, FID and 
MUFFIN contain a minor bug which arises when an attempt is made 
to run these programs with the relocated DOS. The program called 
MOD, included in the software package with the Saturn 32K board 
will repair this bug so that both FID and MUFFIN will run with 
the relocated DOS as well as the normal DOS. 


Modification of the program BOOT13, provided on the DOS3.3 
system master, is required for proper operation with DOS 3.2 
disks initialized under the relocated DOS. MOD will make the 
required changes to BOOT13 to allow use with the relocated DOS. 


V. TECHNICAL INFORMATION: SOFTWARE DETAILS 


The remainder of this chapter is devoted to a technical 
description of the software included with the Saturn 32K RAM 
board. It is intended as a reference to provide information for 
modification/customization of the relocated DOS, as well as pro- 
viding more specific details concerning the operation of of the 
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software (particularly MOVEDOS). 


A. RELOCATED DOS OPERATION 


As described previously, the program called MOVEDOS does 
exactly what its name implies; it moves the existing DOS (ver 3.2 
or 3.3) present at the top of the 48K of user RAM  ($9600-$BFFF) 
into the Saturn 32K board. In addition to being able to maintain 
DOS in the 32K board, the alternate BASIC may reside there as 
well (Integer BASIC on an Apple II plus, Applesoft on an Apple 
II). This is possible because DOS is moved (by MOVEDOS) into the 
16K bank of the 32K card which is not used by BASIC, and is in 
fact not present on Apple's Language card and other manufacturers 
16K RAM boards. All but 4K of this 16K bank is used by the 
relocated DOS and associated monitor routines. The unused 4K 
portion of the second 16K bank of the Saturn board will be used 
by future software packages supporting the 32K RAM board. 


Now, when.a DOS command is invoked from Applesoft, Integer 
BASIC, a machine language routine or the keyboard, it is executed 
by the relocated DOS present in the Saturn 32K board. A small 
portion of DOS is maintained within the lower 48K of RAM from 
SBEOO to $BFFF. This part of DOS includes a short routine which 
serves to enable (turn on) the required part of the Saturn 32K 
board which contains most of DOS, when DOS is called. The DOS 


command is then executed by the relocated DOS in the 32K board, 
after which time that part of the Saturn 32K board is disabled, 
and the system returned to the state it was in prior to the call 
to DOS. The routines which enable the bank of the Saturn 32k 
board containing DOS, as well as disable it when through, are 
located at the top of the user RAM from $BE00 to SBFFF, occupying 
1/2 K. HIMEM is set to reflect this. 


B. USING AN APPLE FIRMWARE CARD 


As was described previously, the relocated DOS has been 
designed to take advantage of an Integer or Applesoft card, if 
present, in addition to the 32K RAM board. A configuration 
program has been provided which facilitates making the approp- 
riate modifications to the relocated DOS so that it can recognize 
an Integer or Applesoft card (see previous section). What the 
configuration program actually modifies are two routines desc- 
ribed as follows. 


1. Whenever DOS is called, the second 16K bank of the Saturn 32K 
RAM Board (where DOS is located) is enabled at the appropriate 
time through a call to a subroutine starting at $BFOO. This 
subroutine does two things: 1) it first insures that the card 
containing the version of BASIC not resident in the main board 
ROMS is disabled. This card may be an Apple Firmware card 
(Applesoft card or Integer card), or a language card, or the 
first half of the 32K RAM Board. 2) The subroutine then enables 
the second half of the 32K card, which is the portion that 
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contains the relocated DOS. The default condition is that in 
which the first 16K bank of the Saturn 32K RAM Board contains the 
BASIC not present in the motherboard ROMS (Applesoft in Apple II 
or Integer in Apple II Plus). In this case, the subroutine would 
first disable the 32K RAM board and then enable the second 16K 
bank of the same card (containing DOS). 


The byte at $BF04 designates the slot containing the card to 
be disabled’ prior to enabling the portion of the Saturn 32K board 
which contains DOS. This byte is modified by the configuration 
program described previously, so as to point to the slot which 
contains the Firmware card (Integer or Applesoft card), if 
present. This modification results in the Integer or Applesoft 
card being disabled prior to enabling the portion of the 32K RAM 
board containing DOS. The default value for this byte is $N2, 
where N = 8 + slot# of Saturn 32K RAM Board. Thus if the Saturn 
32K board is in slot 0, this byte is $82 (since N = 8 + 0). 


2. Upon execution of the DOS command and prior to return, a 
subroutine is executed at $BF17. This routine first disables the 
portion of the Saturn 32K RAM Board which contains DOS (second 
16K bank). What happens next depends upon how DOS was called. 


If DOS had been called with the main board ROMs enabled, 
such as from Applesoft in an Apple II Plus or Integer in an Apple 
II, then the routine at $BF17 insures that the mainboard ROMs are 
enabled prior to the return. If on the other hand, DOS had been 
called from the alternate BASIC (Applesoft in an Apple II, 
Integer in an Apple II plus), the card containing this BASIC is 
enabled prior to return from DOS. This card may be an Integer or 
Applesoft Firmware card or the Saturn 32K board (default). The 
net result is that, if a call to DOS is made from Applesoft, the 
return is to Applesoft, whereas, if the call is from Integer, 
return is to Integer. This will occur regardless of whether, in 
the case of an Apple II Plus, Integer was accessed from the first 
half of the Saturn 32K RAM Board, or from an Integer card. Simi- 
larly, in the case of an Apple II, it makes no difference whether 
Applesoft was accessed from the first half of the Saturn 32K RAM 
Board or from an Applesoft card. 


The byte at $BF1B indicates to the relocated DOS the slot 
which contains the card upon which the alternate BASIC is located 
(Applesoft for Apple II and Integer for Apple II Plus), as well 
as determines whether the card is to be enabled prior to return 
or not. The default is to indicate that this BASIC is located in 


the first 16K Bank of the Saturn 32K RAM board. The configura- 
tion program changes this byte at $BF1B as well as the byte at 
$BFO4, so as to again designate the slot which contains the 
Applesoft or Integer firmware card, if present. Thus, this 


firmware card is enabled, automatically upon return from DOS, 
providing access to the BASIC present in it. 


The default value for the byte at $BFlB is NX, where N = 8 + 


slot# of the Saturn 32K board. This designates that the 
alternate BASIC (Applesoft on an Apple II; Integer on an Apple II 
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plus) is located in the first 16K bank of the Saturn 32K board. 
The value for X will determine whether or not this portion of the 
32K board will be enabled (selected) prior to return. When X=0, 
it is enabled, resulting in the BASIC present within it being 
selected. On the other hand, when X=2, the board is not enabled, 
therefore resulting in the main board ROMs being selected. 


The configuration program merely changes this byte so that 
it points to the slot which contains the Integer or Applesoft 


card. The relocated DOS will then treat this card in a similar 
manner as the first 16K bank of the Saturn 32K board; enabling it 
as required. If for example, slot 2 had been designated as the 


slot containing the Integer (or Applesoft) card, and DOS had been 
called from the BASIC in this card, then the byte at $BF1B would 
have the value $AO (N = 8 + 2 = SA; X=0). 


C. LOADING INTO RAM AT $DO00 - $FFFF 


The relocated DOS has been provided with a feature which 
allows one to load binary data (using BLOAD) into RAM occupying 
the memory space from $D000 - SFFFF. This becomes important when 
one is loading programs for execution up in language cards, 16K 
memory cards and parts of the Saturn 32K RAM Board. In fact, 
such a load must be used to put Integer or Applesoft into the 
Saturn 32K RAM Board, part of which contains DOS. In order to 
clarify this point the following explanation is given. 


The Apple Language card and other manufacturers' 16K cards 
as well as the Saturn 32K board overlay the main board ROM space, 
and therefore are addressed from $D000 to $FFFF. When they are 
accessed, the main board ROMs are disabled. With the normal DOS 
located at the top of user RAM (48K) and a language card or the 
32K RAM Board plugged into a slot in the Apple, binary data can 
be loaded from disk into this memory by first write~enabling the 
card and then executing BLOAD into the $DO000 to SFFFF locations. 
After the load, the memory board may then be write protected (for 
commands to write enable, write protect, etc. see Chapter 7). 


It is up to the user to place the memory board in the proper 
state (for writing) prior to issuing the BLOAD command. If the 
board is not enabled for writing, then DOS will attempt to write 
the binary file being loaded into ROM, having no effect. This 
write enabling overhead is performed in the HELLO program which 
comes with standard DOS 3.3. After determining that a language 
card is in slot 0, the program sets up the card for writing 
(write enables it) and executes a BLOAD of the corresponding 
BASIC. This results in INTEGER BASIC being put into the card on 
an Apple II Plus and Applesoft for an Apple II. The HELLO 
program then write protects the memory on the card so that it is 
not inadvertently overwritten. 


With the relocated DOS, the situation is quite different. 
DOS is now present, and is executed in the Saturn 32K Board. 
Special provisions must be taken to prevent DOS from overwriting 
itself when attempting a BLOAD into the region $D000 - $FFFF. 
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When DOS is actually executing the BLOAD command, the second 
half of the 32K memory board is enabled for both reading and 
writing, since this is the portion of the card which contains the 
relocated DOS and is currently running. If at this point, DOS 
were to BLOAD into the $D000 - $FFFF region, by loading for 
example INTEGER BASIC, it would wipe itself out during the load, 
and the system would bomb. 


What the relocated DOS in fact does (as default), is to load 
the binary data from the file into the first 16K bank of the 
Saturn 32K board, the second half of which contains DOS. 


There are three locations which indicate to the relocated 
DOS where data is to be loaded when an attempt to BLOAD into the 
memory space $D000 - $FFFF is made. These three locaions must be 
set in order to tell DOS the location of the language card, 16K 
RAM board, or 16K bank of the 32K RAM board to be used as the 
destination of the BLOAD. These are set at a default value so as 


to point to the first 16K bank of the 32K RAM board. This 
matches the default set for the location of alternate BASIC 
(Integer or Applesoft). In other words, when a BLOAD into $D000 


-SFFPFF is executed by DOS, the file is loaded into the first 16K 
bank of the 32K RAM board (the second bank of which contains 
DOS). Thus, a simple BLOAD into $D000 - $FFFF of the required 
BASIC (Applesoft or Integer) is all that is required to bring 
this BASIC into the first half of the 32K RAM Board. Then when 
the BASIC is requested (via INT on Apple II Plus or FP on Apple 
II), it is accessed automatically. 


This feature also provides for slot independency of the 32K 
RAM Board, in that, when MOVEDOS is run, these defaults are set 
to point to the slot which contains the Saturn 32K board, 
wherever the board may be located. One may access DOS as well as 
the alternate BASIC (Integer on an Apple II plus, Applesoft on an 
Apple II), from the Saturn 32K board, regardless of what slot it 
is in. 


The three bytes which tell the relocated DOS into which slot 
the BLOAD is to occur can be changed from their default values so 
as to enable automatic BLOADING into RAM boards in other slots. 


One of these bytes is located in a subroutine which disables 
the card (destination of BLOAD), whereas the other two are 
located in a subroutine which enables it for writing. 


The first byte is located at $BFOl1 and is in the form N2 
where N = 8 + slot# of memory card (destination of BLOAD). The 
other two bytes are located at $BF22 + $BF25, and both contain 
the same value: 


NX, where N = 8 + slot# of memory card 

X = determines which 4K bank is to be accessed 
(as well as the 16K bank on the 32K card) 
default: X=3 [Chapter 7 for more details] 
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These bytes are set up to point to the slot which contains 
the 32K RAM board (as default). The first 16K bank of the 32K 
card is indicated as well (X=3). This prevents DOS from being 
destroyed by inadvertently BLOADing into the second 16K bank. 


In summary, the default values are: 


$BFOl SN2, =8+slot# of Saturn 32K board 
SBF22 SN3, u u n 
SBF25 ŚN3, u " u 


Note concerning BSAVE: These bytes used by DOS during BLOADs are 
also used when a BSAVE from $D000 - $FFFF is accomplished. In 
this respect they serve a dual purpose and changing them for one 
function results in the corresponding change in the other. 


D. MEMORY USAGE 


The memory maps presented on the following two pages 
illustrate how the system is organized with the relocated DOS 
present in the Saturn 32K RAM board, as compared to the standard 
DOS memory configuration. For sake of simplicity, the 
configuration applies to an Apple II plus (Applesoft in ROM). 
For Apple II configuration, exchange the contents of main board 
ROMS with that of the first bank of the Saturn 32K board, in each 
diagram. 
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The following memory map describes an Apple II plus with a 
standard DOS present as well as INTEGER BASIC in the 32K RAM 
board. The 2nd 16K bank of this board is unused in this memory 
configuration. For clarity, the additional 4K banks (unused) are 
not shown (see Chapter 7 for more details concerning these 4K 
banks). 


MAIN BOARD lst Bank 2nd Bank 
SFFFF | SFFFF SFFFF 
MAIN MONITOR 
BOARD 
ROMS INTEGER NOT 
BASIC USED 
(APPLESOFT ) 
PR. AID 
$DO00 $DO000 $DO0O0 





Saturn 32K RAM board 


$cooo (4K banks not shown) 


$9600 =HIMEM 





STANDARD DOS CONFIGURATION WITH INTEGER PRESENT IN 32K BOARD 
[APPLE II PLUS] 
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After running MOVEDOS (or booting the relocated DOS), the 


following memory map describes the same system (Apple II plus, 


48K, 
banks 


$FFFF 


$D000 


$9600 


INTEGER present in 32K RAM board). Again, the additional 4K 
are not shown in the figure. 


MAIN BOARD lst Bank 2nd Bank 


$FFFF $FFFF( 
MAIN 
BOARD 


ROMS 


MONITOR 


MONITOR 


INTEGER 
BASIC 


RELOCATED 


DOS 


(APPLESOFT) 


FILE ** 
BUFFERS 


PR. AID 





$D000 spo008 


Saturn 32K RAM board 
(4K banks not shown) 


=HIMEM 





RELOCATED DOS CONFIGURATION WITH INTEGER PRESENT IN 32K BOARD 


[APPLE II PLUS] 


The routines in this. location ($BE00-$BFFF) serve to enable 
the portion of the Saturn 32K board which contains the relo- 
cated DOS and set pointers for operation with this DOS. 


With MAXFILES = 3, all of DOS, including the file buffers 
fits in the second half of the 32K board. If MAXFILES is 
increased beyond 3, then the memory space below $BEO00 is 
used, starting at this location, in increments of 595 bytes 
for the additional file buffers required. HIMEM is 
adjusted to reflect this. 
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E. 


MORE DETAILS CONCERNING MOVEDOS ‘ 


When MOVEDOS is executed, the following occurs: 


1. 


A search is made starting at slot 0, and incrementing 
upward, for a Saturn 32K board. If it is not found, the 
program halts with an appropriate message. 


The version of DOS present in RAM is determined (DOS 
3.2 or 3.3) and the appropriate modifications are made 
to allow it to run (when relocated) up in the 32K RAM 
board. The boot routine is modified to allow loading 
of DOS from disk directly into the memory card. 

INIT is also changed to enable initialization with 

the relocated DOS. 


The modified DOS is then loaded into the Saturn 32K 
RAM board. 


The necessary routines which allow communication with 
the relocated DOS are put up at the top of the user 
RAM space (occupying 1/2K from $BE00 to $BFFF), and 
HIMEM is set to $BEOO. 


The pointers in page 3 are changed indicating the new 
entry points to DOS. 
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F. MISCELLANEOUS ROUTINES, POINTERS, ETC. 


Location 


$BFO00 


$BF17 


$BF1E 


$BF72, $BF73 
$BF60, SBF61 
$BF66 - $BF73 


$BFBB 
$BFE8 


$4C, $4D (INTEGER) 


$73, $74 (APPLESOFT) 


$3D0 


$BEE4 - $BEE8 


Function 


Routine which enables the 16K bank of 
Saturn 32K board which contains DOS. 
(called prior to entering relocated DOS) 
This routine also disables card contain- 
ing alternate BASIC (see section V.B(1)) 
BLOAD and BSAVE also use this routine to 
disable distination of BLOAD (or source 
of BSAVE) as required prior to entering 
the relocated DOS. 


Routine which disables 16K bank of 
Saturn 32K board which contains DOS. 
(called upon exit from relocated DOS) 
This routine also enables the alternate 
BASIC, if required (see section V.B(2)) 


Routine used during BLOAD (and BSAVE) to 
enable the card which is the destination 
of BLOAD (source for BSAVE) when loading 
(or saving) into $D000-$FFFF. (see 
section V C.) | 


BLOAD/BRUN start address (formerly at 
$AA72, $AA73). 


BLOAD/BRUN length (formerly at $AA60, 
$AA61). 


DOS command parameter buffer (formerly 
at $AA66 - $AA73). 


DOS I/O paramter area (formerly $B5BB). 
DOS I/O block for RWTS (formerly $B7E8). 
HIMEM = $BEOO (formerly $9600). 

Routine to re-connect DOS = SBF28 
(formerly at $9DBF). 

Routine which effectively wipes out 
BASIC in Saturn 32K board upon boot 


of relocated DOS (slot 0 only) by 


writing O at location $E000. Change 
to NOP's to defeat this feature. 
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G. INTERFACE ROUTINES TO RELOCATED DOS 


Example configuration: 


Apple II plus with Saturn 32K RAM board in slot 0, INTEGER 
card in slot 2, destination of BLOAD = slot O, lst 16K bank of 
32K board (default). INTEGER BASIC resident. 


Routine to enable relocated DOS (also used during BLOAD/BSAVE): 


SBFOO 8D 82 CO STA $C082 :TURN OFF DESTINATION OF 
;BLOAD/BSAVE (1ST 16K 
;BANK OF SATURN 32K BD.) 


SBFO3 8D A2 CO STA S$COA1 ;TURN OFF INTEGER CARD 

; (SLOT 2) 
$BF06 8D 87 CO STA $C087 ;TURN ON 2ND 16K BANK OF 
$BFO9 8D 87 CO STA $C087 ; SATURN 32K BOARD 


; (RELOCATED DOS) 
$BFOC 60 RTS 


Routine to disable relocated DOS and re-enable INTEGER: 


$BF17 8D 82 CO STA $C082 ; TURN OFF SATURN BOARD 
; (RELOCATED DOS) 
SBF1A 8D AO CO STA $COAO ;TURN ON INTEGER CARD 


:FOR RETURN TO INTEGER 
; (=$COA2, FOR RETURN TO 
;APPLESOFT) 

$BF1D 60 RTS 


Routine to enable destination of BLOAD (source for BSAVE): 


$BF1E 8D 82 CO STA $C082 ;TURN OFF SATURN BOARD 
; (RELOCATED DOS) 

$BF21 8D 83 CO STA $C083 ;TURN ON DESTINATION OF 

$BF24 8D 83 CO STA $C083 ;BLOAD/BSAVE (1ST 16K 


;BANK OF 32K BOARD) 
$BF27 60 RTS 
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Chapter 5 
RAMEXPAND ' 


RAMEXPAND is a software package consisting of a set of 
functions for extending the amount of RAM available to Applesoft 
and Integer programs. RAMEXPAND will use the memory on one or 
more Saturn 32K RAM Boards as well as that on any 16K board 
present in the system. Information in the form of data and 
programs or subroutines can be saved on these extension RAM 
boards for later retrieval. RAMEXPAND allows one to save 
complete programs which can later be loaded and run, overlay and 


chain subroutines and program segments, or save and recall 
arrays. 


Flexibility has been incorporated into RAMEXPAND to allow 
portions of the memory board(s) (Saturn 32K RAM Board, 16K board) 
to be reserved for such things as the alternate BASIC (Applesoft 
in Apple II, Integer in Apple II Plus). This memory can be 
reclaimed for use by RAMEXPAND at any time it is desired. 


I. CHARACTERISTICS OF RAMEXPAND 


A. TERMINOLOGY 


Throughout this chapter, the term “extended RAM" will be 
used to describe the total memory present in the system contained 
on expansion RAM boards (Saturn 32K RAM Board(s), 16K expansion 
RAM board(s)). It should be noted that it is NOT necessary to 
have a 16K RAM board for any of the software provided by Saturn 
Systems; however, our software will take advantage of any 16K 
card which you may have purchased prior to the introduction of 
the Saturn 32K RAM Board. 


B. REQUIREMENTS AND MEMORY USAGE 


In order to use RAMEXPAND, DOS must be first relocated by 
running MOVEDOS or booting a disk which has been initialized with 
a relocated DOS. (See Chapter 4.) 


RAMEXPAND occupies two portions of memory. Most of the 
RAMEXPAND system is located in the Saturn 32K board which 
contains the relocated DOS and occupies the unused 4K bank within 
the second 16K bank of the board (bank which contains the 
relocated DOS). This is 4K bank 2B (see Technical Information 
section, Chapter 7). One page of memory from $BDOO to $BDFF (just 
below the interface routines to the relocated DOS) is also used 
by RAMEXPAND and HIMEM is set to protect this portion. 


The RAMEXPAND system consists of three files, RAMEXPAND, 
RAMEXPAND . LOW, and RAMEXPA.LOAD. The program RAMEXPA.LOAD serves 
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to load the RAMEXPAND system into memory and set various poin- 


ters. The file RAMEXPAND is the portion of the system which 
resides in the Saturn 32K RAM board, RAMEXPAND.LOW is the 
portion which resides in low RAM (normally at HIMEM). This low 


RAM portion of RAMEXPAND can actually be loaded and executed 
anywhere in low RAM (0 - 48K), although it is normally located at 
HIMEM, with HIMEM being lowered to protect it. 


C. DATA STRUCTURE 


RAMEXPAND saves and recalls selected parts of program text 


or data. Each portion is saved in an independent area in 
extended RAM. These areas are called segments. Each segment can 
contain a program, a part of a program, or the contents of an 
array. When information is saved in a segment, it must be given 
a name. When the information is retrieved, it is identified with 
this name. The "names" are in fact integers, and can be 
specified as variables which contain the segment names when 
calling RAMEXPAND, if desired. Segment names may be integers 
between 1 and 32,767. Zero, negative numbers, or numbers greater 


than 32,767 are illegal segment names. 


D. MEMORY ALLOCATION 


RAMEXPAND uses areas of the memory indicated as being 
available on one or more Saturn 32K RAM Boards as well aS on a 
16K RAM board. RAMEXPAND treats each 16K bank of a given memory 
card as ‘consisting of two blocks of memory, one which is 12K 
in size, and the other 4K. Thus a Saturn 32K board consists of 4 
blocks, two 12K blocks and two 4K blocks. On the other hand, a 
16K board contains only 2 blocks, one 12K and one 4K. 


Specific numbers have been assigned to these blocks and are 
used for specifying a particular block. Numbers are used to 
identify the blocks to be used by RAMEXPAND when the system is 
initialized. These numbers are 8, 16, 32, and 64. 


The memory organization of a Saturn 32K board is given in 
the following figure. The particular number used to designate 
the depicted block is shown in brackets. 


The table associated with this figure gives the relationship 
between these block designations used by RAMEXPAND and the bank 
designations used in the Technical Information section (Chapter 
7) of this manual. 


As a reference, the relocated DOS resides in the 12K block 


of the second 16K bank (RAMEXPAND block designation 16), and 
RAMEXPAND itself resides in the 4K block with designation 64. Of 


course, neither of these blocks should be specified for use by 
RAMEXPAND as data storage space. 
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$FFFF 


$E000 





$DO00 


16K Bank 1 16K Bank 2 


Relationship between RAMEXPAND block designation and the 


designation established in the Technical Information Chapter of 
this manual. 


RAMEXPAND 
16K bank Size DESIGNATION 
1 12K 8 4K Bank 1A + memory in region 
SEOOO - $FFFF 
1 4K 32 4K Bank 1B 
2 12K 16 4K Bank 2A + memory in region 


$E000 — $FFFF 


2 4K 64 4K Bank 2B 


The RAMEXPAND block designations for a 16K RAM board 
correspond to those which are used to describe the first 16K bank 
in the above figure. Thus, 


12K block 
4K block 


RAMEXPAND block designation 8 
RAMEXPAND block designation 32 


Noi 
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SPECIAL REQUIREMENT IF LANGUAGE CARD IS PRESENT 


The Apple Language Card requires špecial treatment for use 
with RAMEXPAND. This is due to the presence of the Autostart ROM 
on the Language Card. The memory allocation for RAMEXPAND has 
been modified slightly in order to accomodate the language card. 
The RAMEXPAND block specification numbers remain the same, with 
the only difference being that the top 2K of each 12K block is 
not used by the RAMEXPAND system. As a result the blocks 
corresponding to the numbers 8 and 16 are 10K in size rather than 
12K, when an Apple Language Card is used. 


RAMEXPAND is told that a language card is present at the 


initialization and installation step, when the system is being 
set up. 


II. USE OF RAMEXPAND 


A. INSTALLING RAMEXPAND 
The following procedure describes the steps which must be 
taken in order to install RAMEXPAND in the system. 


1. DOS must be first relocated into the Saturn 32K Board. (BRUN 
MOVEDOS or boot a relocated DOS disk.) 


2. Next RAMEXPAND should be loaded using the loading program: 
RAMEXPA. LOAD 

This program loads the two portions of the RAMEXPAND system (the 
portion which resides in the Saturn 32K RAM Board as well as the 
"low" RAM portion residing at $BDOO to $BDFF). It then sets 
HIMEM to protect the "low" RAM portion and sets up locations 10 - 
12 to point to the entry point of RAMEXPAND. Thus RAMEXPAND can 
be called by simply using a CALL 10 or the USR function (Apple- 
soft). 

When RAMEXPA.LOAD is run, it will ask if RAMEXPAND is to 
be installed in the board containing DOS (default). 


USE DOS SLOT = O (Y/N/YL/NL) 
(L IF HAVE LANGUAGE CARD) ? 
Responses: 


a) Y response at this point will indicate that RAMEXPAND is to 
be loaded into the board indicated. 


b) N response will result in an inquiry being made for the slot 
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into which RAMEXPAND is to be loaded. 


C. YL response is used to indicate that RAMEXPAND is to be 
loaded into the board indicated. In addition, it signifies 
that an Apple Language Card is being used in the system. 


D. YN response is same as B above. In addition, it signifies 
that an Apple Language Card is being used in the system. 


RAMEXPAND is now installed in the system and ready for use. 
Two initialization and set-up procedures are generally required 
prior to actually moving programs and data into extended RAM by 
using the appropriate RAMEXPAND functions. 


Before discussing these initialization procedures, the 


method of calling and communicating with RAMEXPAND will be desc- 
ribed. 


B. COMMAND SET-UP 


Prior to calling RAMEXPAND, a command must be set up. This 
command tells RAMEXPAND what function is to be performed as well 


as any necessary parameters. The command must be placed in the 
string CMS. RAMEXPAND will always look at CM$ for its command 
when called. 

The command should contain 5 values, separated by commas. 
Each value may be a number or the name of a variable. In several 
cases the value must be a variable name. A sample command is as 
follows: 

CMS = "A,B,C,D,E" 


In general the values represent the following: 


1. FUNCTION. The first value identifies the function to be 
performed. This must be an integer in the range O to 14. 

2. SEGMENT NAME. The second value gives the name of the RAM 
segment to use. (values: integer 1 - 32,767) 

3. ERROR STATUS. The third value must be a variable name. 
RAMEXPAND will store a status value in the variable upon comp- 
letion of the function. This can be used to determine if the 


function was performed successfully. 


4. START. The fourth value depends upon the particular 
function. It may represent the start of a program area, or an 
array name. 


5. END. The fifth value also depends upon the particular 
function. It may represent the end of a program area. 
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C. CALLING RAMEXPAND 


RAMEXPAND is called from BASIC programs using the CALL 
statement. Since locations 10 - 12 ($A - $C) are set to point to 
RAMEXPAND, a CALL 10 statement and in Applesoft the USR function 
both serve to call RAMEXPAND. 


Thus, in summary, in order to execute a RAMEXPAND command, 
the command string CM$ is first set up, and then RAMEXPAND is 
called through a CALL 10, etc. This process is repeated for each 
command to be executed. | 


D. INITIALIZING RAMEXPAND 


After RAMEXPAND has been installed (see previous section, 


INSTALLING RAMEXPAND), it must be initialized. This is 
accomplished through the RAMEXPAND initialization function 
(function code = 14). The command string to initialize RAMEXPAND 
is as follows: 

CMS = "14,0,A,0,0" 
where A = error status variable. 


E. ATTACHING MEMORY BLOCKS 


Following initialization, the extended RAM memory to be used 
by RAMEXPAND should be specified. The connect function (#9) is 
used to attach blocks of memory to the system by indicating to 
RAMEXPAND which blocks of memory are to be used in a particular 
expansion RAM board (Saturn 32K RAM Board or 16K RAM board). 
This function can be used to "attach" a single block of memory or 
multiple blocks of memory within a given expansion memory board. 


To attach a single block to RAMEXPAND, the chosen block and 
slot number containing the memory card are stipulated as follows: 


1. A block selection parameter is calculated by adding the 
slot# of the memory card to the block designation #. (For 
example, the block selection parameter of the first 12K bank of a 
Saturn 32K board in slot #2 is 2 + 8 = 10). 


2. This block selection parameter is supplied as the second 
parameter in CMS when the connect function (#9) is executed. 
Thus in above example CMS = "9,10,A,0,0" where A = error status 
variable. 


Additional calls to RAMEXPAND may be used to connect other 
blocks of memory as desired. More than one block within a given 
memory card can be attached with a single call to RAMEXPAND, by 
merely adding the corresponding block numbers along with the 
slot# to generate the block selection parameter. Thus, to 
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specify the first and second 12K block of a Saturn 32K board in 
slot #2, the block selection parameter is: 


2+ 8 + 16 = 26 


and CM$ = "9,26,A,0,0". 


When the connect funcction (#9) is executed, these blocks 
will be attached to RAMEXPAND. Additional connect function calls 
to RAMEXPAND should be executed for each expansion memory board 
to be used by RAMEXPAND. Some of the more common block selection 
parameter values are given in section VIII, under the subsection 
describing the "connect" function (#9) syntax. 


RESERVING SPACE FOR BASIC 


Space in a Saturn 32K RAM Board can be reserved for the 
alternate BASIC (Integer BASIC in Apple II Plus; Applesoft in 
Apple II), if desired, by not "attaching" the first 12K block 
(block designation #8) of the Saturn 32K RAM board. The 4K block 
(designation #32) may be used for storage by RAMEXPAND without 
disturbing BASIC in the 12K block. 


USING A FIRMWARE CARD 


If An Apple Firmware card is present in the system, the 
RAMEXPAND system can be accessed from it as well. This is accom- 
plished by first configuring the relocated DOS to access the 
language in the firmware card (see Chapter 4). Operation in this 
manner will enable one to gain maximum benefit of the extended 
RAM from both Applesoft and Integer BASIC. 


III. PRECAUTIONS 


A. PROTECTING RAMEXPAND 


Since the relocated DOS and RAMEXPAND occupy the blocks with 
designation numbers 16 and 64 respectively (in the Saturn 32K RAM 
Board which contains them), these blocks should not be specified 
for use by RAMEXPAND. 


B. SETTING MAXFILES 


Once the low RAM portion of RAMEXPAND (RAMEXPAND.LOW) has 
been installed, it cannot be moved. As a result, MAXFILES must 
not be increased after RAMEXPAND has been installed. What should 
be done is to declare the largest value of MAXFILES required 
prior to running RAMEXPA.LOAD. 
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C. RELOADING RAMEXPAND 


Everytime RAMEXPA.LOAD is run, the low RAM portion of 


RAMEXPAND is loaded and MAXFILES is lowered to protect it. By 
simply re-running this program, HIMEM will continue to be 
lowered. To prevent this from happening, execute a MAXFILES 


command to reset HIMEM before re-loading RAMEXPAND. 


D. SWITCHING BETWEEN BASICS (FP OR INT) 


Whenever FP or INT is executed (used when switching BASICS, 
etc), HIMEM must be declared so as to protect the low RAM portion 
of RAMEXPAND. If this is not done, then the data saved by 
RAMEXPAND will be lost. The required value for HIMEM is given 
when RAMEXPA.LOAD is run. 


E. RESETTING RAMEXPAND ENTRY POINTS 


The entry point into RAMEXPAND that is used when calling it 


is normally stored in locations 11-12. This entry point corres- 
ponds to the first location of the low RAM portion of RAMEXPAND, 
which is normally at HIMEM. If locations 11-12 are changed or 


clobbered, they must be reset before using RAMEXPAND from BASIC 
programs through a CALL 10 or the Applesoft USR function. 


F. DECLARING VARIABLES 


Variables to be used as parameters in RAMEXPAND command 
strings should be declared before use. This can be accomplished 
by simply assigning a value to the variable, prior to calling 
RAMEXPAND . If this precaution is not taken, RAMEXPAND will 
either not return the value expected or flag an error. (see 
section IV.A.3.) 


IV. ERROR HANDLING 


A. DESCRIPTION 


Each RAMEXPAND function has an associated error status which 
is generally passed to a variable stipulated in the command 
string CMS. The following characteristics describe the error 
handling process under a variety of conditions. 


1. If the command string CM$ is not found, there is no command 
string to indicate an error status variable. In this case, there 
is no indication of any error. 
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2. If no variable is specified for the error status, no error 
status is returned and the function continues. If no other error 
occurs, the function will be successful. 


3. If a non-existent variable (i.e., a variable which was not 
declared previously) is specified for error status, there is no 
indication of any error, even if one occurs. This can be quite 
confusing in the event that an error does occur, since no 
indication of this error will be given via the error status 
variable. 


4. If an error status variable is found, but some other variable 
is not found, an error is returned. No other action takes place. 


5. Actions occuring when other errors take place depend upon the 
situation and the error. In most (but not all) cases, no action 
will have taken place, after an error condition is encountered. 


B. ERROR SUMMARY 


= illegal function 

= variable not found 

= memory block already in use 

= memory block not found 

= illegal block selection parameter 

memory block is not RAM 

= segment name already in use 

= segment not found 

= illegal segment name 

= no program is specified (ending line number precedes 
starting line number) 

1l = no array specified 

12 = not enough room in extended RAM to store data 

13 = not enough room in normal (low) RAM to recall program 


CO vw DAOU GAMM 
li 


V. CURRENT LIMITATIONS 


A. The Fetch and Run function (#2) always uses the same BASIC as 
the calling program used. 


B. Overlays must not be larger than the original space, i.e. the 
space where these overlays will be loaded in the program. 
As a result, some care must be exercised when overlaying; 
RAMEXPAND does not currently change "end of program" pointers 
or move variable tables. 


C. The Store array (#5) and Fetch array (#6) functions pass one 
array at a time, and use the whole array. 


1. For the Fetch function, if the saved segment is 
smaller than the target array, the end of the target 
array is unchanged, and the data in the segment will 
overlay the existing data in the array only up to the 


37 





point where the source data ends. 


2. If the the saved segment is larger than the target 
array, not all of the segment is retrieved. Only 
data up to the end of the target array is transferred. 


D. In Applesoft, string arrays are not supported for the array 
functions. 


VI. EXAMPLE PROGRAM 


An Applesoft demonstration program has been provided to 
illustrate some of the RAMEXPAND functions. This program 
consists of the following files. 


DEMO DEMO2 APPEND1 APPEND2 APPEND3 DEMOUTPUT 


The program will demonstrate the operation of the following 
functions. 


Store array (#5) 
Fetch array (#6) 
Store subroutine or program segment (#3) 
. Fetch subroutine or program segment (#4) 


Pewne 


In addition, several support functions are used. 


1. Initialize RAMEXPAND (#14) 
2. Connect Blocks (#9) 


A. To execute the demonstration program, 


1. Relocate DOS (BRUN MOVEDOS or boot a relocated DOS). 
2. Run the loading program, RAMEXPA.LOAD. 
3. Run DEMO 


(note: This program will not use the space in the 
Saturn 32K board where the alternate BASIC is normally 
loaded. As a result, one can run the program from 
Applesoft in the Saturn 32K board on an Apple II.) 


B. PROGRAM OPERATION 


1. The demonstration program will first initialize 
RAMEXPAND (function #14) and attach the 4K bank with 
block designation #32 to the system using the connect 
function (#9). In this way, the space normally occupied 
by the alternate BASIC is reserved, in the event that 
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it is required. 


2. The program will then set up some custom driver 
routines (used for PROGRAM LISTING menu option) by 
BRUNing DEMOUTPUT. 


3. Three program segments will then be loaded from disk 
(APPEND1, APPEND2 and APPEND3) and saved by RAMEXPAND 
in extended RAM using the Store subroutine or program 
segment funtion (#3). 


4. The main portion of the demonstration program (DEMO2) 
will be loaded and a menu displayed. The following 
options are available. 


a) LIST - This option will serve to list the program 

b) ARRAY DEMO - This option will demonstrate the 
saving and loading of an array from extended RAM 
using RAMEXPAND functions. 

c) LOAD PROGRAM SEGMENT 1 - This will load the 
previously stored program segment starting at 
statement number 5000. 

d) LOAD PROGRAM SEGMENT 2 (same as in c) 

e) LOAD PROGRAM SEGMENT 3 (same as in c) 

f) EXECUTE PROGRAM CURRENTLY IN MEMORY - This will 


run the program segment which was loaded last. 


While the demonstration program may serve as an example of a 
few of the available RAMEXPAND functions, it by no means exhausts 
all of the possibilities. 
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VII. SUMMARY OF AVAILABLE FUNCTIONS 


RAMEXPAND provides the following functions (specified as the 
first value in the command string): 


O - no operation 


l - store complete program in extended RAM 

2 - fetch and run program from RAM 

3 - store subroutine or program segment in extended RAM 

4 - fetch subroutine or program segment from extended RAM 
5 - store contents of an array in extended RAM 

6 - fetch contents of an array from extended RAM 

7 - exchange contents of an array between normal RAM and 


extended RAM 
8 - delete extended RAM segment (makes space available again). 


9 - connect new block of extended RAM to enable RAMEXPAND 
to use it. 


10 - disconnect block of extended RAM to prevent RAMEXPAND 
from using it. 


11 - fetch total amount of free space in extended RAM 
12 - fetch name of "next" segment 


13 - (not implemented yet) preload BASIC program from disk 
file into extended RAM 


14 - initialize RAMEXPAND 
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VIII. COMMAND SYNTAX AND DESCRIPTION 


0 - No-op 


No values other than function. 


1 - Store program 

function, segment name, error status, unused, unused 

This function stores all of the current program in a new 
segment. The new segment is given the name specified in the 


second value. The segment name may not already exist. 


Error status: 


O = success 
1 = illegal function 
2 = variable not found 
7 = name already exists 
9 = illegal segment name 
12 = not enough room in extended RAM 
2 - Fetch and run program 


function, segment name, error status, unused, unused 


This function retrieves the named segment as a new program. 
It then runs the new program. If it succeeds, then RAMEXPAND 
doesn't return to the calling program. 


Error status: 


= success 

illegal function 
variable not found 
segment not found 
illegal segment name 
memory full 


WYOUOBDHO 


3 =- Store subroutine or program segment 


function, segment name, error status, starting line number, 
ending line number 


This function stores a portion of a program in a new 


segment. The new segment is given the name specified in the 
second value. The new segment name must not exist. The portion 
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of the program from the starting line number up to and including 
the ending line number is saved. 


Error status: 


success 

illegal function 

= variable not found 

segment already exists 

= illegal segment name 

= no program area specified 

= not enough room in extended RAM 


DOG JNDHO 
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4 - Fetch subroutine or program segment 


function, segment name, error Status, start line number, un- 
used 


This function retrieves the named segment. It overwrites 
the portion of the current program beginning at the starting line 
number. Thus it overlays part of the existing program. 


Error status: 


= success 

= illegal function 

= variable not found 

segment not found 

= illegal segment name 

= not enough room in normal memory 


WO GNF O 
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5 - Store array 
function, segment name, error status, array name, unused 


This function stores the contents of an array in a new 
segment. The new segment is given the specified name. The array 
must be specified by name; i.e., this value may not be a number. 


Error status: 


success 

illegal function 

variable not found 

segment name already exists 
illegal segment name 

no array specified 

not enough room in extended RAM 


DD ŁO JNDH- O 
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6 - Fetch contents of array 


function, segment name, error status, array name, array 
length 


This function retrieves the named segment and stores the 
contents in the named array. The array must be specified by 
name. If the array length value is specified, it must be a 
variable name. If it is specified,  RAMEXPAND will return the 
number of bytes actually stored in the array in this variable. 
This can be used to determine how much data was returned. The 
number must be divided by the size of an array element to 
determine how many elements it represents. For integers, the 
size is 2 bytes. For reals, the size is 6 bytes. 


Error status: 


O = success 
l = illegal function 
2 = variable not found 
8 = segment not found 
9 = illegal segment name 
ll = no array specified 
7 - Exchange array 
function, segment name, error status, array name, array 
length 
This function exchanges the contents of an array in normal 
RAM with the contents of an array in extended RAM. Other than 
the exchange, this function acts just like the Fetch Array 
function. The array must be specified by name. If the array 
length value is specified, it must be a variable name. If if is 
specified, RAMEXPAND will return the actual number of bytes 
stored in the array in this variable. This can be used to 
determine how much data was returned. This number should be 
divided by the number of bytes per array element to determine how 
many elements it represents. For integers, the size is 2 bytes. 


For reals, the size is 6 bytes. 
Error status: 


success 

illegal function 
variable not found 
segment not found 
illegal segment name 
no array specified 


Nd l 
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8 — Delete segment 
function, segment name, error status, unused, unused 


This function deletes the segment named. This makes the 
space in extended RAM available for other uses. 


Error status: 


success 

illegal function 
variable not found 
segment not found 
illegal segment name 


VOD DH O 
low Ww ou ou 


9 — Connect blocks 
function, block selection, error status, unused, unused 


This function identifies new blocks of memory for use by 
RAMEXPAND. The block selection parameter was described 
previously (ATTACHING MEMORY BLOCKS, section II.E.). 


COMMON VALUES OF BLOCK SELECTION PARAMETER: 


1. With one Saturn 32K board used for the alternate BASIC, 
DOS and RAMEXPAND, there is one block (4K) left for use. 
The block selection parameter for this block is 32 + slot#. 


2. With one Saturn 32K board used for DOS and RAMEXPAND, but 
not BASIC, 16K is available for RAMEXPAND to use. The 
block selection parameter for this block is 40 + slot #. 


3. If the alternate BASIC is accessed from a firmware or 
language card, the situation is the same as (2). The block 
‘selection parameter in this case is 40 + slot #. 


4. If more than one Saturn 32K board is present, more than one 
"connect" call to RAMEXPAND is required. For the board 
which contains DOS and RAMEXPAND, see (1)-(3). For the 


other boards, to use the entire 32K board for RAMEXPAND, 
the block selection parameter is 120 + slot #. 


5. If additional 16K boards are to be used by RAMEXPAND, the 
block selection parameter for each 16K board (to use the 
entire card) is 40 + slot #. 


Error status: 


0 
1 


success 
illegal function 
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variable not found 

block already in use 

illegal block selection parameter 
RAM not in specified slot 
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10 - Disconnect blocks 
function, block selection, error status, return-name, unused 


This function disconnects blocks of memory from use by 
RAMEXPAND. The specified blocks must be empty or RAMEXPAND will 
not disconnect them. The block selection format is the same as 
specified in the "connect" function. If the return-name value is 
specified as a variable name, and if a segment still remains 
stored in a block, the segment name will be returned in the 
variable named. 


Error status: 


success 

illegal function 

variable not found 

block not in use 

illegal block selection parameter 

block not empty. error status is segment name. 


JUTENH O 
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11 - Retrieve total amount of free space 
function, unused, error status, unused, free space variable 
This function computes the amount of free space in extended 
RAM. If a variable name is specified for the free space 


variable, the total number of bytes is returned in the variable. 


Error status: 


success 
illegal function 
variable not found 


NFO 


12 - Retrieve next segment name 
function, segment name, error status, length variable, unused 


This function looks up an existing segment name. It then 
returns the next name following the specified name. This may be 
used to step through all the segments to see which names are 
used. The segment name value must be a variable name to have a 
new name returned. If the length variable is specified, the 
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length of the new segment will be returned in the length 
variable. To get the first segment name, zero should be 
specified for the starting segment name. If no segments follow 
the specified segment, the name returned will be zero. 


Error status: 


0 = success 

1 = illegal function 

2 = variable not found 

8 = segment name not found 

9 = illegal segment name 
13 - Preload program from disk file 


(not implemented at this time) 


14 - Initialize RAMEXPAND 
function, unused, error status, unused, unused 


This function restarts RAMEXPAND from scratch. All blocks 
are disconnected, and any existing data is lost. 


Error status: 


success 


0 
1 illegal function 
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Chapter 6 
PSEUDO-DISK 


This software package enables one to use the Saturn 32K 
Board for storing programs and data in a very similar manner as 
is done on disk. Of course, the 32K board does not in any way 
resemble a disk drive; however, through appropriate software, DOS 
can be fooled into thinking that the card is just another disk 
drive. As a result, applications programs which use DOS for 
saving and loading programs and data will also see the Saturn 32K 
card as a disk drive. 


In order to be able to use the Saturn 32K RAM Board as a 
pseudo-disk, controlling software routines must be loaded and 
some initialization accomplished. These programs are provided 
on the diskette included with the Saturn 32K RAM Board and are 
used to set up the pseudo-disk. Two of these programs are writ- 
ten in BASIC (PSEUDO DISKA and PSEUDO DISKI). These programs 
prompt the user for various parameters required by the third 
program (SATURN DISK), and then BRUNs this program. 


It is this third program (SATURN DISK) which actually 
installs the memory controlling routines, patches DOS, and init- 
ializes the pseudo-disk directory. ` 


I. FEATURES AND REQUIREMENTS OF THE PSEUDO DISK SYSTEM 


The pseudo-disk is designed to operate with a standard DOS 
3.3 or 3.2. The current version will not operate with a relo- 
cated DOS 3.2 or 3.3. The software also requires the presence of 
a disk controller card in slot 6. 


The pseudo-disk system will work with more than one Saturn 
32K RAM Board, as well as 16K cards in addition to the Saturn 32K 
board, making available all of this memory for storage. 


A feature has been provided which allows reservation of 
space for BASIC, if access to the alternate BASIC (Integer on an 
Apple II plus; Applesoft on an Apple II) is desired. 


II. SETTING UP THE PSEUDO DISK 


Both Applesoft and Integer versions of a BASIC program are 
provided. This program is used to set up parameters for the 
binary program which actually installs the routines for using the 
memory card(s) as a pseudo-disk. The Integer version is used on 
an Apple II and the Applesoft version on an Apple II plus. The 
required BASIC program, as well as the binary program (SATURN 
DISK) should be transferred to another disk. 
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To install the pseudo-disk: 
A. Run the BASIC program 


l. PSEUDO DISKA on Apple II plus 
2. PSEUDO DISKI on Apple II 


B. As the program prompts, answer the questions (see below for 
description). The following will then occur: 
1. The binary program SATURN DISK will be re-saved with 


parameters set up from answers to the questions in step B. Then, 
at a later time if one wishes to set up the pseudo-disk again 
with the same configuration as previously used, the BASIC program 
does not have to be run again, a BRUN SATURN DISK is sufficient. 


2. The pseudo-disk software will be installed and 
initialized. 

3. The file SDP will be created and saved on the current 
disk (described in section III.A., entitled RECONNECTING THE 


PSEUDO-DISK). 


SET-UP PROGRAM QUESTIONS (PSEUDO DISKA, PSEUDO DISKI): 


1. HOW MANY REAL DISK DRIVES? 

Enter the number of drives used in the system. The pseudo- 
disk will be assigned the next sequential drive designation, 
working from slot 6 backward (slot 5, 4, etc.). Thus, for 
example, if one drive is specified, the pseudo-disk will be slot 
6 drive 2. On the other hand, if two drives are specified, then 


the pseudo-disk will be assigned to slot 5 drive 1, and so forth. 


2. HOW MANY SATURN 32K RAM BOARDS? 
Enter the number of Saturn 32K RAM Boards in the system. 
(slot numbers will be requested) 


3. HOW MANY 16K RAM BOARDS? 


Enter the number of 16K boards in the system. (slot numbers 
will be requested) 


4. IS AN APPLE FIRMWARE CARD PRESENT? 

If an Integer or Applesoft card is in the system, answer Y. 
This will result in a request for the slot number of the card. 
This option allows one to use the language in the Firmware card 
(even from a slot other than 0) and thus maximize use of the RAM 
boards for the pseudo-disk while having access to both BASIC's. 


5. DO YOU WISH TO RESERVE SPACE FOR BASIC? 

If the answer to question #4 was Y, then this question will 
not be asked. If space for the alternate BASIC is desired in the 
memory card present in slot 0, then answer Y. This will result 
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in the first half of a 32K card in slot O (or all of the memory 
on a 16K card in slot 0) being reserved for this BASIC and not 
used for storage of programs, data, etc. Programs and data 
present on the pseudo-disk can also be accessed from this BASIC 
present in the memory card (Integer BASIC on an Apple II plus, 
Applesoft on an Apple II), provided that space is reserved (by 
answering yes to the above question), so that it is not used by 
the pseudo-disk system. 


6. NUMBER OF SECTORS FOR DIRECTORY? 
Enter the number of sectors to be allocated for the 


directory. This will determine the number of files possible on 
the pseudo-disk, and enables one to maximize the use of the 
memory by not reserving excessive directory space. A typical 


number is 4. 


III. USING THE PSEUDO-DISK 


Once the pseudo-disk has been initialized and installed (by 
running the appropriate BASIC program or BRUNing the SATURN DISK 


program), it can be used as a standard disk drive. Its directory 
will be empty and files can be transferred to it from a real disk 
drive using FID. The number of files that can be stored on the 


pseudo-disk is limited by the amount of memory being used for it. 
(Saturn 32K boards + 16K cards) 


The data will remain on the pseudo-disk as long as power is 
applied, until the data is deleted, or the drive is initialized 
(via INIT).-The data is still present even after a re-boot of the 
system. 


A. RECONNECTING THE PSEUDO~DISK 


The routines which control the memory cards and allow them 
to emulate a disk drive are connected to DOS through a patch in 
the RWTS subroutine. This patch is set up when the system is 


installed using either the BASIC set-up program or by BRUNing 
SATURN DISK. 


However, when DOS is booted, the patch is overwritten, and 
must be re-installed in order to access the pseudo-disk. This 
can of course be accomplished by running the BASIC set-up program 
(or BRUNing SATURN DISK), however such action will result in 
erasing any files already present on the pseudo-disk. The patch 
can be installed, thus re-connecting the pseudo-disk, without 
destroying its contents by using the program SDP which is actual- 
ly generated by the system when it is installed. All that is 
required is to BRUN SDP. SDP is relocatable and can be therefore 
run starting at any location by explicitly designating the load- 
start address, e.g., BRUN SDP,A$1000 will load and execute SDP 
starting at $1000. 
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After SDP has been RUN, the pseudo-disk can be accessed 
again as usual, with all previously saved files intact. 


B. DUAL DOS OPERATION 


Due to its ability to be used under both DOS 3.2 and 3.3, 
the pseudo-disk can in fact be used to transfer files from DOS 
3.2 to 3.3 and Vice versa. It can also be used as a universal 
medium, independent of the version of DOS. 


The following procedure may be followed in order to switch 
DOS's and use the pseudo disk from both. 


1. After installing the pseudo-disk (using the installation 
program or BRUNing SATURN DISK) transfer a copy of the 
patch program, SDP, to the other version of DOS. This 
program will be required in order to re-attach the 
pseudo-disk after a boot. 


2. Boot the other DOS as is normally done. 


3. BRUN SDP under this new DOS (SDP was transferred in 
step 1.). 


4. Files which were present on the pseudo-disk under the 
previous DOS will now be accessable. Essentially, the 
pseudo-disk format is independent of the version of DOS 
being used. 


IV. PRECAUTIONS 


A. BOOTING DISKS 


Care must be exercised when booting, particularly if the 16K 
bank which normally contains the alternate BASIC (Applesoft on an 
Apple II, Integer on Apple II plus) is being used by the pseudo- 


disk. If the BASIC is loaded into the memory card upon boot in 
this case, the contents of the pseudo-disk will be destroyed by 
being overwritten by BASIC, and cannot be recovered by running 
SDP. 


B. INITIALIZING DISKS 


Since the RWTS subroutine within the DOS present in memory 
has been patched to operate with the pseudo-disk. care must be 
taken when initializing disks. When a diskette is initialized 
(using INIT function) with the pseudo-disk installed, a copy of 
the patched DOS is written to the diskette. This diskette will 
not boot properly because of the patches to DOS. It is therefore 
recommended that diskettes be initialized only under a standard 
DOS, prior to installation of the pseudo-disk, so as to avoid 
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this problem. 
V. HOW IT WORKS 


The pseudo-disk system consists of three parts: 
A. PSEUDO-DISK HANDLER ROUTINES 


The diskette sector to RAM board memory address translation 
and actual transfer of data to and from the memory boards is 
accomplished by the major portion of the pseudo-disk system, 
located in the memory cards. These routines are located in the 
top most page of each 16K bank of memory (S$FFOO - SFFFF). Each 
16K card as well as the two 16K banks on the Saturn 32K Board(s) 
contain these routines. As a result, no matter which bank is 
actually enabled at any given time, the controlling routines are 
resident. 


B. INTERFACE ROUTINES TO THE PSEUDO-DISK HANDLER 


As was the case with the relocated DOS, there must be some 
routine present in low memory (0 - 48K) to enable (turn on) the 
Memory card prior to entry into the handler routines present in 
the board. A similar routine must be used upon exit, to insure 
that the card is off (disabled) upon return to DOS and the user 
program. 


These interface routines are located at $9CDO, just below 
DOS and above the file buffers. The file buffers have been moved 
down slightly ($30H bytes) to allow room for these routines. The 
routines are protected somewhat by being located in this space, 
and are not overwritten unless DOS is rebooted. A source listing 
of these routines is given in the next section. 


C. DOS RWTS patch 


In order for DOS to use the pseudo-disk system, a patch to 
RWTS has been made. The instruction at $BDOO has been changed to 
a JSR $9CDO, a jump to the interface routine, which will enable 
one of the memory boards prior to entry into pseudo-disk handler 
located in the card (S$FFOO). 
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VI. INTERFACE ROUTINE SOURCE LISTING 


The following is a source listing of the interface routines 
to the PSEUDO-DISK. 


*** Routine called prior to entry into PSEUDO-DISK handler*** 


9CDO 2C 82 CO BIT $c082 ;TURN OFF CARD IN SLOT O 

; (BASIC MAY BE RESIDENT HERE) 
9CD3 2C 87 CO BIT SCONX ;TURN ON ONE OF THE RAM BOARDS 
9CD6 2C 87 CO BIT SCONX H N = 8 + slot# 

; X = 3 or 7 
9CD9 4C 00 FF JMP SFFOO ;GO TO PSEUDO DISK HANDLER 

z ( 


NOW RESIDENT IN BOARD) 


**k*k* Routine. entered upon exit from PSEUDO-DISK handler**** 


9cDC 48 PHA 

9CDD 08 PHP , 

9CDE BD 82 CO LDA $€082,X ;TURN OFF MEMORY CARD 
9CE1 BD 82 CO LDA $C082,X ;WHERE CAME FROM. 

9CE4 AD 82 CO LDA $C082 ;MAY BE PATCHED TO TURN 
9CE7 AD 82 CO LDA $C082 ;ON ANOTHER CARD PRIOR 


;TO RETURN (SEE NOTE 1) 


**k* These routines will determine what BASIC was resident*** 
*kkkkkkkkkk*k* Drior to the call and return to it********żxk%* 


OCEA AD B6 AA LDA $AAB6 ;GET FLAG 

9CED DO 04 BNE $9CF3 

9CEF A9 20 LDA $20 ;RETURN TO INTEGER 
9CF1 DO 02 BNE $9CF5 

9CF3 A9 AC LDA $4C ;RETURN TO APPLESOFT 
9CF5 20 B2 A5 JSR SA5B2 ;BACK TO BASIC 

9CF8 28 PLP 

9CF9 68 PLA 

OCFA 60 RTS 

Note 1: 


These two instructions can be patched to enable one to BLOAD 
into a given memory board. 


This is required when one wants to load Integer BASIC (Apple 
II plus) or Applesoft (Apple II) into the card in slot 0, as 
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normally occurs upon boot of a system master (DOS 3.3). These 
locations should be changed to: 


$9CE4 AD 81 CO LDA $CO81 
$9CE7 AD 81 CO LDA  $CO81 


prior to the BLOAD (to write enable the memory card), and changed 
back after the BLOAD in order to protect the data in the card. 


The HELLO program for loading BASIC into the memory card 
(such as the one supplied on the DOS 3.3 system master) can be 
modified to make these patches. This will enable one to load 
BASIC into the memory card in slot 0 even after the pseudo-disk 
has been installed. The following statements may be added to the 
HELLO program in order to accomplish this: 


Add the following statement immediately prior to the point where 
"BASIC is bloaded: 


IF PEEK(-17152) = 32 THEN POKE -25371,129 : POKE ~25368,129 
and immediately following the BLOAD, add: 
IF PEEK(-17152) = 32 THEN POKE -—25371,130 : POKE -25368,130 


The modified HELLO program can be used with either a 
standard DOS or one which has been patched for operation with the 
pseudo-disk, since the above statements test for the presence of 
the pseudo-disk prior to making the appropriate changes. 





VII. PSEUDO DISK PARAMETER TABLE 


The primary purpose of the BASIC program used during the 
installation of the pseudo-disk is to set up the parameter table 
in the binary program SATURN DISK. This program then uses these 
parameters in order to configure the pseudo-disk system. The 
parameters in this table are defined as follows: 


LOCATION ALLOWED VALUES DESCRIPTION 

$6003 0-7 SLOT# - This is the slot assigned 
to the pseudo-disk. 

$6004 1,2 DRIVEŻ - This is the drive no. 
assigned to the pseudo-disk. 

$6005 l1 - 15 DIRECTORY - The number of sectors 
to be allocated as directory 
sectors. 

$6006 0 - 7, $80 - $87 SLOT TABLE - This is a list, term- 

max number = 4 inated by $FF, containing the slot 


numbers and types of RAM boards to 
be used by the pseudo-disk. 

The most significant bit (bit 7) 
indicates whether the card is a 
16K board or a Saturn 32K board. 
(see note 2) 


Bit 7 = 0 16K RAM board 
Bit 7 = 1 32K RAM board 
$6010 O - 7; SFF FIRMWARE CARD - This is a flag 


which indicates whether an Apple 
Firmware Card is being used, and 
if so, gives the slot# of the card. 


O- 7 Firmware card present 
(slot #) 
SFF No Firmware card present 


note 2: 

This bit can also be used to specify that only the second 
16K bank of the Saturn 32K board is to be used. Such action 
will take place if bit 7 = 0, and a Saturn 32K board is in the 
slot indicated. This feature makes it convenient to reserve the 
first 16K bank of the Saturn 32K board in slot 0 for use by 
BASIC. 
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Chapter 7 
TECHNICAL INFORMATION 


I. ADDRESSING THE SATURN 32K RAM BOARD 


The Saturn 32K RAM board contains 32K bytes of RAM memory, 
divided into 16K byte banks. These banks are selected independ- 
ently of each other, and in many respects appear as two 16K RAM 
boards occupying a single slot. 


The two 16K banks occupy the same memory space as the Apple 


main board ROMS, from $DO00 to $FFFF. In this respect, they 
share the same memory space as the ROMS. At any given time, 
either the main board ROMS are accessed, or one of the 16K banks, 
but not both. Since the ROM space from $D000 to $FFFF is only 


12K long, and each bank on the Saturn 32K board is 16K bytes in 

size, only 12K of one or the other of these banks can be accessed 
at any given time. This is because the 4K memory space from 
$c000 to SCFFF is used by the Apple II for I/O and cannot be 
shared by the RAM on the Saturn 32K board. 


In order to access the full 16K bytes of each bank on the 
Saturn board, the lower 4K of the RAM board address space is used 
twice. Each 16K bank of the Saturn 32K board is divided into two 
4K banks occupying the memory space from $D000 to $DFFF, and one 
8K block from $E000 to $FFFF. Within a given 16K bank, one may 
select either of the two 4K banks to occupy the space from $D000 
to $DFFF. 


One has access to the full 32K on the Saturn 32K board by 
selecting it in 12K segments. To define a given segement, two 
things must be designated. 


1. The 16K bank (1 or 2) to be accessed. 

2. The 4K bank to be used within the 16K bank. 
The following convention has been established to describe the 
Saturn 32K board. The two 16K banks are denoted 16K Bank 1 and 
16K Bank 2. Within each 16K bank, the 4K banks are described as 
4K Bank A and 4K Bank B. In order to distinguish the 4K banks 


within 16K Bank 1 from those in 16K Bank 2, the 4K bank designa- 
tion is preceded by 1 or 2, indicating the 16K bank to which it 
belongs. Thus, 4K Bank 1A describes the first 4K bank within 16K 
Bank 1. 


There are four possible memory combinations available. The 
following memory map depicts schematically these combinations 
with the appropriate designations (16K bank and 4K bank) given to 
the left. The shaded areas represent the particular portion of 
memory described by the given designation. 
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II. CONTROLLING THE SATURN 32K RAM BOARD 


The Saturn 32K board is controlled using 16 locations in the 
range $CONO — $CONF, where N = 8 + Saturn board slot #. Thus for 
slot zero operation, the control addresses are in the range $C080 
to SCO8F. These locations are in the Apple's peripheral I/O 
space as described in Apple II reference manual, p. 80. They are 
used by the Saturn 32K board to control the following functions: 


l. Select the Saturn 32K board RAM or the Apple main board 
ROM. 


2. Select the desired 16K bank to access (bank 1, bank 2). 


3. Determine which 4K bank (A or B) within each 16K bank 
is to be used. 


4. Write enable or write protect RAM. 


In order to set the Saturn 32K board in a given state, a 
memory access to the particular location corresponding to the 


desired state is all that is required. This can be accomplished 
by either reading or writing to the location. From BASIC, a POKE 
or PEEK will accomplish this memory access. A machine language 


load or store will also serve the same purpose. 


The lower 4 bits of the control address selects the mode of 
operation of the Saturn 32K board, as summarized below. 


Address line (0 determines whether the board will be write 
enabled or write protected. (AO = O for write protect; AO = 1 for 
write enable). 


Address lines 0 and 1 are used to determine whether the main 
board ROMs are accessed, or the RAM on the Saturn 32K board. 


Address line 2 selects one of the two 16K banks. (A2=0 for 
16K bank 1; AŻ=l for 16K bank 2). 


Address line 3 determines which 4K bank within the selected 
16K bank to use. (A3=0 for 4K bank A; A3=1 for 4K bank B). 
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The following table summarizes the various mode combinations 
which are available. 


Control 

Address Function 
ŚCONO 16K Bank 1; 4K Bank 1A; RAM read; Write protect 
SCON1 16K Bank 1; 4K Bank 1A; ROM read; Write enable 
$CON2 16K Bank 1; 4K Bank 1A; ROM read; Write protect * 
$CON3 16K Bank 1; 4K Bank 1A; RAM read; Write enable 
$CON8 16K Bank 1; 4K Bank 1B; RAM read; Write protect 
SCONO 16K Bank 1; 4K Bank 1B; ROM read; Write enable 
SCONA 16K Bank 1; 4K Bank 1B; ROM read; Write protect * 
SCONB 16K Bank 1; 4K Bank 1B; RAM read; Write. enable 
SCON A 16K Bank 2; 4K Bank 2A; RAM read; Write protect 
SCON5 16K Bank 2; 4K Bank 2A; ROM read; Write enable 
SCON6 16K Bank 2; 4K Bank 2A; ROM read; Write protect * 
SCON7 16K Bank 2; 4K Bank 2A; RAM read; Write enable 
SCONC 16K Bank 2; 4K Bank 2B; RAM read; Write protect 
SCOND 16K Bank 2; 4K Bank 2B; ROM read; Write enable 
SCONE 16K Bank 2; 4K Bank 2B; ROM read; Write protect * 
SCONF 16K Bank 2; 4K Bank 2B; RAM read; Write enable 


Notes: 


N = 8 + Saturn 32K board slot $ ( for slot 0, N=8). 


16K Bank 1 = lst 16K bank of Saturn 32K board 
16K Bank 2 = 2nd 16K bank of Saturn 32K board 
4K Bank 1A = lst 4K bank of 16K bank L 
4K Bank 1B = 2nd 4K bank of 16K bank 1 


4K Bank 2A lst 4K bank of 16K bank 2 


4K Bank 2B 2nd 4K bank of 16K bank 2 

ROM read: The RAM on the Saturn board is disabled for 
reading and the main board ROM enabled. 

RAM read: The RAM on the Saturn board is enabled for 
reading. 

Write enable: The RAM on the Saturn 32K board is enabled 


for writing. 


Write protect: Data cannot be written to the RAM on the 
Saturn Board. 


* This combination (ROM read and Ram write protect) 


effectively disables the Saturn 32K board. The board is 
in this state upon power up. 
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Using the appropriate mode combination (previous table), any 
given byte of memory on the Saturn 32K board can be accessed. In 
fact, in several modes (CON1, CON5, CON9, COND) the main board 
ROM's are accessed during a read from $D000 — $FFFF, whereas the 
RAM on the Saturn 32K board is written to during a write opera- 
tion. This enables one to write to the RAM while running BASIC 
in ROM which occupies the same address space. This is possible 
since BASIC is being read from ROM while the program may in fact 
be writing to RAM (via POKES). 


Note Concerning Write Enabling the RAM: 


In order to enable the Saturn 32K board for writing to RAM, 
the corresponding control address (for mode desired) must be 
accessed twice. This is required for any of the write enable 
modes (odd number control addresses). If the board is already in 
a write enabl state (e.g. $CON1), and another mode is desired 
which is write enabled as well (e.g. $CON3), then only one access 
to the control address corresponding to this new mode is 
required. If on the other hand, the board is ina write pro- 
tected state (e.g. CONO) prior to the change, two access to the 
control address are required to write enable the board. 


III. SATURN 32K RAM BOARD MEMORY USE 


A. RELOCATED DOS 


The relocated DOS occupies 16K Bank 2 and 4K Bank 2A, using 
the full 12K of memory space from $DO00 - $FFFF, for DOS, monitor 
routines and associated file buffers. This bank is enabled using 
control address $CON?. The 4K Bank 2B is not used by the relo- 
cated DOS. 


B. ALTERNATE BASIC 


When the alternate BASIC (INTEGER for an Apple II plus; 
Applesoft for an Apple II) is present in the Saturn 32K board, it 
occupies 16K Bank 1 and 4K Bank 1A, and is enabled for reading 
using control address SCONO. The 4K Bank 1B is not used by this 
BASIC. 


IV. SWITCH OPERATION 


The switch located on the back of the Saturn 32K board 
determines whether the main board ROM's or the RAM board is 
enabled when RESET is pushed. The particular operation which 
occurs depends upon the state of the board as well as the 
position of the switch. 
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Switch down: 


When the switch is in the "down" position, the RAM board is 
disabled and the Apple main board ROMS are enabled upon RESET. 
This will occur regardless of the particular mode that the board 
was in prior to the RESET. 


Switch up: 


When the switch is in the "up" position, two different 
things happen upon RESET, depending upon whether the board is 
write protected or not. 


A. Write enabled (not write protected): 
If the board was in a write enabled state prior to the 
RESET, then the Saturn 32K board will be in the RAM read 
enabled state after the RESET. Thus the RESET results 
in the RAM being enabled, if not already enabled. 


B. Write protected: 
If the 32K board was in a write protected state prior to 
the RESET, then no change in the state of the board 
will occur upon RESET. Thus, if the board was RAM read 
enabled, it will remain so upon RESET, whereas, if the 
board had been disabled (ROM read enabled) it will 
remain disabled upon RESET. 


V. SPECIFICATIONS 


A. Memory 
Type: dynamic 
Access time: 200ns 

B. Power consumption (average). 
+5V 60ma 
+12V 190ma 
-5V -140ma 
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SATURN 32K RAM BOARD WARRANTY 


Saturn Systems, Inc. (SSI) warrants this product to be free 
of defects in material and workmanship for a period of one (1) 
year from the original date of purchase to the original user 
only. During this period, SSI will repair (or, at its option, 
replace) this product free of charge, provided that it is 
returned with dated proof of purchase to Saturn Systems, Inc., 
P.O. Box 8050, Ann Arbor, MI 48107. This warranty does not 
apply, if in the opinion of SSI, the product has been damaged by 
accident, misuse, neglect or misapplication as a result of 
service or modification by other than Saturn Systems. 


THIS WARRANTY IS IN LIEU OF ALL OTHER EXPRESS WARRANTIES, STATE- 
MENTS OR REPRESENTATIONS, AND UNLESS STATED HEREIN, ALL SUCH 
WARRANTIES, STATEMENTS OR REPRESENTATIONS MADE BY ANY OTHER 
PERSON OR FIRM ARE VOID. ALL IMPLIED WARRANTIES IN CONNECTION 
WITH THIS SALE, INCLUDING THE WARRANTY OF MERCHANTABILITY, SHALL 
BE OF THE SAME DURATION AS THE WARRANTY PERIOD STATED ABOVE. 
SOME STATES DO NOT ALLOW LIMITATIONS ON HOW LONG AN IMPLIED 
WARRANTY LASTS, SO THE ABOVE LIMITATION MAY NOT APPLY TO YOU. 


IN THE EVENT THAT THIS PRODUCT SHALL PROVE DEFECTIVE IN WORKMAN- 
SHIP OR MATERIALS, YOUR SOLE REMEDY SHALL BE THE REPAIR OR 
REPLACEMENT AS STATED IN THIS WARRANTY, AND UNDER NO CIRCUM- 
STANCES SHALL SATURN SYSTEMS BE LIABLE FOR ANY LOSS OR DAMAGE, 
DIRECT, INCIDENTAL OR CONSEQUENTIAL, ARISING OUT OF THE USE OF, 
OR INABILITY TO USE, THIS PRODUCT. SOME STATES DO NOT ALLOW THE 
EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, 
SO THE ABOVE LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU. 


Saturn System, Inc. 
P.O. Box 8050 
Ann Arbor, MI 48107 
Phone: (313 )665-6416 


